Copyright: Copyrights (c) 1997-1998,Rise Software ltd.


WhatIs

About RSCalendar

Description

RSCalendar is a lightweight 32-bit ActiveX control that provides user-friendly date selection like drop-down calendar found in Microsoft® Outlook™. RSCalendar lets you effortlessly add a state-of-the-art user interface to your existing and future projects.

Features

- Support user's regional settings (native names of the monthes, week days and first day of week).

- Bindable to data source.

- Friendly date selections.

- Parses keyboard input and formats date string.

- Supports various date formats.

- Truly lightweight ActiveX control (less than 150k).

- Can be fully customized through properties.

- Requires no external DLL's for easier deployment and eliminates potential DLL conflicts.


New
What's new in Version 1.1

New Properties added:

FirstDate

LastDate

EnableFirstDate

EnableLastDate

rsUnSelectableColor

Text

Other:

- Minor drawing optimization


FirstDate

Description

Returns or sets the lower bound of the date available to display

Data Type

Date

See also

LastDate

EnableFirstDate


LastDate

Description

Returns or sets the upper bound of the date available to display

Data Type

Date

See also

FirstDate

EnableLastDate


EnableFirstDate

Description

Enables/disables the date's lower bound check.

Data Type

Date

See also

FirstDate


EnableLastDate

Description

Enables/disables the date's upper bound check.

Data Type

Date

See also

LastDate


rsUnSelectableColor

Description

Returns or sets the color used to draw dates not between FirstDate and LastDate, if EnableFirstDate and/or EnableLastDate properties sets to True

Data Type

OLEColor – Hexadecimal number representing the RGB value of the color.

See also

FirstDate

LastDate

EnableFirstDate

EnableLastDate


Text

Description

Returns or sets the text contained in the edit area

Data Type

String.


ForeColor

Description

Sets or returns the foreground text color used in edit box.Default is the sytem's defined Text color.

Data Type

OLEColor – Hexadecimal number representing the RGB value of the color.

See Also

BackColor


BackColor

Description

Sets or returns the background color of edit box.Default is the sytem's defined window background color (usually white).

Data Type

OLEColor – Hexadecimal number representing the RGB value of the color.

See Also

ForeColor


Appearance

Description

Returns or sets the paint style of control on Form or parent window.

Data Type

Integer.

Can be 0 for Flat style or 1 to draws control with three-dimensional effects.


Font

Description

Returns/sets the font of edit box.

Data Type

Font object.

See Also

rsCalendarFont


FirstWeekDay

Description

Returns or sets the first day of the week on the dropdown calendar.

Data Type

Integer.

Use one of the following constants:

rsSystemDayOfWeek 	= 0

rsSunday	= 1

rsMonday	= 2

rsTuesday	= 3

rsWednesday	= 4

rsThursday	= 5

rsFriday	= 6

rsSaturday	= 7


rsDate

Description

Sets or returns the date displayed by RSCalendar control.

Data Type

VARIANT

Has Variant/Date type when the control hold any valid date value, Variant/Empty when no date selected.

See Also

DateFormat


rsActiveMonthColor

Description

Sets or returns the color used as text color when dropdown calendar draws days in current month.Default is the sytem's defined text color.

Data Type

OLEColor – Hexadecimal number representing the RGB value of the color.

See Also

rsOtherMonthColor	rsOutlineTodayColor	rsHighliteColor


rsOutlineTodayColor

Description

Sets or returns the color used to outline today's date in dropdown calendar. Default is the dark red color.

Data Type

OLEColor – Hexadecimal number representing the RGB value of the color.

See Also

rsOtherMonthColor	rsActiveMonthColor 	rsHighliteColor


rsOtherMonthColor

Description

Sets or returns the color used as text color when dropdown calendar draws days not in current month.Default is the sytem's defined disabled text color.

Data Type

OLEColor – Hexadecimal number representing the RGB value of the color.

See Also

rsActiveMonthColor	rsOutlineTodayColor	rsHighliteColor


rsHighliteColor

Description

Sets or returns the color used to highlite current selection in dropdown calendar. Default is the sytem's defined highlite color.

Data Type

OLEColor – Hexadecimal number representing the RGB value of the color.

See Also

rsOtherMonthColor	rsActiveMonthColor 	rsOutlineTodayColor


TodayText

Description

Returns or sets the caption of the button used for select the current date (placed on the bottom left corner of dropdown calendar).

Data Type

String.

See Also

NoneText


rsCalendarFont

Description

Returns/sets the font used for drawing dropdown calendar.

Data Type

Font object.

See Also

Font


NoneText

Description

Returns or sets the caption of the button used for select "no date" (placed on the bottom right corner of dropdown calendar). The "none" value means that no any date assigned to the control. The value of NoneText property is also used in edit box to indicate that no date selected.

Data Type

String.

See Also

TodayText


DateFormat

Description

Returns or sets the date format of the currently selected date when it is displayed in control's edit box.

DateType

String.

Example

RSCalendar1.DateFormat = "ddd, MMMM dd yyyy"

Date Format Syntax

The following table identifies characters you can use to create user-defined date formats:

Character	Description

(/)	Date separator. In some locales, other characters may be used to represent the date separator. The date separator separates the day, month, and year when date values are formatted. The actual character used as the date separator in formatted output is determined by your system settings.

d	Display the day as a number without a leading zero (1 – 31).

dd	Display the day as a number with a leading zero (01 – 31).

ddd	Display the day as an abbreviation (Sun – Sat).

dddd	Display the day as a full name (Sunday – Saturday).

M	Display the month as a number without a leading zero (1 – 12). If m immediately follows h or hh, the minute rather than the month is displayed.

MM	Display the month as a number with a leading zero (01 – 12).

MMM	Display the month as an abbreviation (Jan – Dec).

MMMM	Display the month as a full month name (January – December).

yy	Display the year as a 2-digit number (00 – 99).

yyyy	Display the year as a 4-digit number (100 – 9999).

See Also

rsDate


Licence
License Agreement

The product in this package (libraries and object code) is proprietary to Rise Software, Ltd.  and is protected by US and International Copyright Laws.  Rise Software retains the title to and ownership of the Product.  You are licensed to use this Product on the following terms and conditions:

LICENSE - The licensee is defined as the individual  software developer utilizing the Product.  This license is not for an entire company but for a single developer.  Rise Software hereby grants the licensee a nonexclusive license authorizing the licensee to use the enclosed Product on one computer at a time for development purposes. The licensee is also permitted to distribute this product to one, and only one web server to host the ActiveX control.  Please contact Rise Software if you require additional licenses.  You may incorporate the sample code into your applications.  Use of this product by more than one individual or by anyone other than the licensee terminates, without notification, this license and the right to use this product.

YOU MAY NOT:  Distribute, rent, sub-license or otherwise make available to others the software or documentation or copies thereof, except as expressly permitted in this License without prior written consent from Rise Software.  In the case of an authorized transfer, the transferee must agree to be bound by the terms and conditions of this License Agreement.

RESTRICTIONS: - You may use this Product in your business application for sale or distribution as long as:

The product that you produce and/or distribute is NOT a software development product, a product that is sold primarily to software developers or system integrators or a development environment of any kind.  Please contact Rise Software, Ltd. for special commercial licensing provisions in these circumstances.

The software serial number and user must be registered with Rise Software in order to receive support or distribution rights.

You may not remove any proprietary notices, labels, trademarks on the software or documentation.

You may not modify, decompile, disassemble, reverse engineer or translate the software.

FILES THAT MAY BE DISTRIBUTED WITH YOUR APPLICATION:

RSCalendar.ocx

TERM - You may terminate your License and this Agreement at anytime by destroying all copies of the Product and Product Documentation.  They will also terminate automatically if you fail to comply with any term or condition in this Agreement.

LIMITED WARRANTY - This software and documentation are sold "as is" without any warranty as to their performance, merchantability or fitness for any particular purpose.  The entire risk as to the quality and performance of the software is assumed by the licensee.  In no event shall Rise Software or anyone else who has been involved in the creation, development, production, or delivery of this software be liable for any direct, incidental or consequential damages, such as, but not limited to, loss of anticipated profits, benefits, use, or data resulting from the use of this software, or arising out of any breach of warranty.


System Requirements

Windows95 or Windows NT development environment that support ActiveX controls.


Technical Support

If you are having problems using the RSCalendar ActiveX, please make sure that the control was registered by the installation program. If not, use the RegSvr32.exe program to register the RSCalendar.ocx file  The REGSVR32.EXE is included with your development environment. If the problem is not fixed please contact our technical support staff. We provide technical support via e-mail only. Please send your questions to support@risesoft.com. Note: please include a complete description of the problem and  the version of RSCalendar that you are using.

We welcome suggestions

We at Rise Software welcome your suggestions for improving RSCalendar control. Please email your suggestions to info@risesoft.com.

Please visit our website at www.risesoft.com